home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 January / Macworld (1997-01).dmg / Shareware World / Maths & Science / DynRisk 4.0.3 / DynRisk-Help / DynRisk-Help.rsrc / TEXT_6526.txt < prev    next >
Text File  |  1996-08-30  |  2KB  |  32 lines

  1. Trim2
  2.  
  3. A double trim function. This function separates the input values in three categories defined by the ‚Äúc‚Äù and the ‚Äúd‚Äù parameters. Assuming that the ‚Äúc‚Äù parameter is below the ‚Äúd‚Äù parameter, the function behaves as follows:
  4.  
  5. If the input value is less than the ‚Äúc‚Äù parameter, the output value is equal to the ‚Äúb‚Äù parameter.
  6.  
  7. If the input value is between the ‚Äúc‚Äù and the ‚Äúd‚Äù parameters, the output value is calculated according to the following linear function:
  8.  
  9.     Output = b + (Input - c)(a - b)/(d - c)
  10.  
  11. If the input value is greater than the ‚Äúd‚Äù parameter, the output value is equal to the ‚Äúa‚Äù parameter.
  12.  
  13. If the ‚Äúd‚Äù parameter is less than or equal to the ‚Äúc‚Äù parameter, the ‚Äúd‚Äù parameter is ignored, and the function behaves exactly like the Thresh1 function. In such cases you should simply use the Thresh1 function instead to avoid confusion.
  14.  
  15. Note that the ‚Äúa‚Äù parameter does not have to be greater than the ‚Äúb‚Äù parameter. To obtain useful results, however, the ‚Äúa‚Äù parameter should not be equal to the ‚Äúb‚Äù parameter. (If you let ‚Äúa‚Äù be equal to ‚Äúb‚Äù, the output value will always be equal to this common value.)
  16.  
  17. In the special case when ‚Äúa‚Äù is equal to ‚Äúd‚Äù, ‚Äúb‚Äù is equal to ‚Äúc‚Äù, and ‚Äúc‚Äù is less than ‚Äúd‚Äù, the Trim2 function takes the following simplified form:
  18.  
  19.     Output = Max(Min(Input, a), b)
  20.  
  21. Hence, in this case input values less than ‚Äúb‚Äù are replaced by ‚Äúb‚Äù, input values greater than ‚Äúa‚Äù are replaced by ‚Äúa‚Äù, and all other input values are passed on unchanged.
  22.  
  23. Default parameter values:
  24.     a = 1, b = 0, c = 0, d = 1
  25.  
  26. Example:
  27.     a = 4, b = 1, c = 2, d = 5
  28.  
  29.     Input = 1  =>  Output = 1
  30.     Input = 4  =>  Output = 3
  31.     Input = 6  =>  Output = 4
  32.